home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 2 / MacMania 2.toast / Demo's / Tools&Utilities / FileKit Folder / File Kit Manual next >
Encoding:
Text File  |  1992-06-01  |  7.9 KB  |  161 lines  |  [ttro/ttxt]
  1.  
  2.  
  3. File Kit Manual
  4. Version 1.0.2
  5.  
  6.  
  7.  
  8.  
  9. 1. What is File Kit?
  10.  
  11. File Kit is a utility that lets you 
  12.  
  13.         • Examine and change all system information about files, including file
  14.             attributes that are new with system 7.0. 
  15.  
  16.         • Examine information about volumes. 
  17.  
  18.         • Open and close any file on your Mac
  19.  
  20.         • Compare and delete files.
  21.  
  22. File Kit is great for programmers and power users who want more information and control of their files and disks. 
  23.  
  24.     When you launch the program, File Kit creates the main file selection window, which works like an ordinary file selection list. This window provides you with three basic functions: Vol Info, File Info, and Compare Files.
  25.  
  26.  
  27.  
  28.  
  29.  
  30. 2. Vol Info
  31.  
  32.     This control will display a dialog that describes the current volume. You may use the drive button in the main file selection window to select a volume; it cycles through all mounted volumes. The information dialog displays:
  33.  
  34.     • Name - The name of the volume
  35.  
  36.     • Vol RefNum - This is the reference number that programmers use in File Manager traps.
  37.  
  38.     • Drive Number - This is the number of the disk drive that this volume is stored on.
  39.  
  40.     • Device Driver - This is the refNum of the device driver that controls the volume.
  41.  
  42.     • Total File Count - The total number of files on the volume.
  43.  
  44.     • Total Folder Count - The total number of folders on the volume.
  45.  
  46.     • Block Size - This is the unit of allocation for storage on this volume.
  47.  
  48.     • Total size - The total amount of storage on this volume.
  49.  
  50.     • Space Available - The total amount of available storage on this volume.
  51.  
  52.     • Created - When the volume was last initialized.
  53.  
  54.     • Modified - When the volume was last modified. Changing any file on the volume modifies the volume.
  55.  
  56.     •    Backed Up - When the volume was last backed up.
  57.  
  58.  
  59. Additionally, This dialog will display which “volume attributes” the selected volume has. The possible attributes are: 
  60.  
  61.     • Startup - The volume is the startup volume. When you start your Mac, it will use the System Folder from this volume.
  62.     
  63.     • External - The volume is implemented by an external file system.
  64.  
  65.     • Bootable - The volume could be selected as a Startup volume.
  66.  
  67.     • Access Controls - The volume supports access controls for files and folders.
  68.  
  69.     • Desktop Manager - The volume supports the Desktop Manager. This means programmers can use Desktop traps for this volume.
  70.  
  71.     • BTree Manager - The volume supports the B-Tree Manager. 
  72.  
  73.     • Uses File ID’s - The volume supports the file ID’s. This means programmers can use traps that take File ID’s to operate on files on this volume.
  74.  
  75.     • CatSearch - Programmers can use the CatSearch function on this volume.
  76.  
  77.  
  78.  
  79.  
  80.  
  81. 3. File Info
  82.  
  83.     This function will display and optionally change information about a file or folder. To open the File Info dialog, select a file or folder in the main file selection window, and click on this button. Double clicking a file name, or selecting a file and hitting the return key will also open this dialog. The file Info dialog displays the following information:
  84.  
  85.     • File Name - The name of the file. You may change this by typing a new name in this field and selecting the Change button.
  86.  
  87. This dialog displays several other attributes for each file. WARNING! These values are used by your system software to manage files.  DO NOT CHANGE THESE VALUES UNLESS YOU ARE ABSOLUTELY SURE YOU KNOW WHAT YOU ARE DOING. 
  88.  
  89.     • File Type and File Creator - This is information used by the Finder to determine what type of file this is. For example, applications have type value ‘APPL’ and control panels have ‘cdev’. The creator is a signature, and identifies the application that created a file; and application and its related files all have the same Creator value. Both the type and creator are always four letter values, but one or more letters may be a space.You may change either of these by typing a new name in this field and selecting the Change button.
  90.  
  91.     • Data Size - This is the logical size of the data fork of the file. Every file has two forks, the data fork and the resource fork. The total file size is the sum of the sizes of these forks.
  92.  
  93.     • Resource size - This is the logical size of the resource fork of the file. Every file has two forks, the data fork and the resource fork. The total file size is the sum of the sizes of these forks.
  94.  
  95.     • Created - When the file was created.
  96.  
  97.     • Modified - When the file was last modified. 
  98.  
  99.     • Backed Up - When the file was last backed up. Note that third-party backup programs may or may not set this value, but the system software does not change the value.
  100.  
  101.     • Data fork and Resource fork - The file info dialog also displays the refNum of the data fork and resource fork. A refNum describes an open file, and programmers use refNum values in many File System operations. If the file is not open, then this field displays the message: “Closed”. There are also controls to open or close the two forks of the file. Be very careful when you close a file, the application that opened that file expects it to stay open.
  102.  
  103.     Each file also has several attributes that may be set or reset with the checkboxes on the right side of the dialog. Changes to these attributes will not take place until you click the Change button, so if you make a change and then click on Cancel the file is unchanged. The following attributes are controlled by checkboxes:
  104.  
  105.     • Invisible - The file is visible in the finder
  106.  
  107.     • Locked - The file may be modified in any way. This is the same attributed that is displayed by the “Locked” checkbox when you get information about a file in the Finder.
  108.  
  109.     • Name Locked - The file may be renamed in the Finder. Note that you can change the name of a file in File Kit even if this attribute is set.
  110.     
  111.     • Alias - The file is an alias file. This is only used by System 7.0.
  112.  
  113.     • On Desktop - The file is displayed on the desktop in the Finder.
  114.  
  115.     • Custom Icon - The file contains a custom icon.
  116.  
  117.     • Bundle - The file contains resources to define a new type and creator bundle. 
  118.  
  119.     • Inited - This is used by the Finder to manage the display of icons in file windows.
  120.  
  121.     • Stationary - The file is a stationary file. This is only used by System 7.0.
  122.  
  123.     • Shared - The file is shared.
  124.  
  125.     • Contains Inits - The file contains startup code resources.
  126.  
  127.  
  128.  
  129.  
  130. 4. Compare Files
  131.  
  132.     Finally, File Kit allows you to compare two files, to see if they are identical or not. When you select this button, File Kit will prompt you for the two files and compare them. Note that the first part of the resource fork (first 256 bytes) are ignored. Apple system software stores information about the location and other attributes in this area, and two files that appear identical to the user and for all practical purposes are identical may have different information stored here.
  133.  
  134.  
  135. 5. Shareware Notice
  136.  
  137.  
  138. File Kit is shareware, if you use it please send 15$ (US) to:
  139.  
  140.                 Dawson Dean, Attn: Software Publishing
  141.                 654 Blair Ave
  142.                 Piedmont, CA 94611
  143.  
  144. To report bugs, or for more information, you may reach me online at the following addresses:
  145.  
  146. America Online: DawsonDean
  147. Internet: dawson@cs.cornell.edu
  148.  
  149. Copyright
  150. Copyright © 1991 Dawson Dean. This manual and the software described in it are copyrighted with all rights reserved.
  151.  
  152. Trademarks
  153. Apple is a registered trademark of Apple Computer, Inc.
  154.  
  155. Limited Warranty on Media and Manual
  156. Dawson Dean makes no warranty, either explicit or implied, with respect to this software, its quality, performance, or fitness for a particular purpose. This software and manual are sold “as is”, and you the purchaser are assuming the entire risk as to its quality and performance.
  157.  
  158. In no event will Dawson Dean be liable for direct, indirect, special, incidental, or consequential damages resulting from any defect in the software or its documentation. In particular, Dawson Dean shall have no liability for any damage to programs or data used with this product, including the cost of recovering or repairing such programs or data.
  159.  
  160. The warranty and remedies set forth above are exclusive and in lieu of all others, oral or written, express or implied. 
  161.